home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1997 May / EnigmA AMIGA RUN 18 (1997)(G.R. Edizioni)(IT)[!][issue 1997-05][EAR-CD II].iso / earcd / util / sys / msys_1_2.lha / Doc / loadwb.doc < prev    next >
Text File  |  1996-07-23  |  4KB  |  90 lines
  1. C/LoadWB                                                             C/LoadWB
  2.  
  3.    NAME
  4.        LoadWB -- start Workbench. (V42)
  5.  
  6.    SYNOPSIS
  7.        LoadWB [-DEBUG] [DELAY] [CLEANUP] [NEWPATH] [HIDE] [RAMICON]
  8.  
  9.    TEMPLATE
  10.        LoadWB "DEBUG=-DEBUG/S,DELAY/S,CLEANUP/S,NEWPATH/S,HIDE/S,RAMICON/S"
  11.  
  12.    FUNCTION
  13.        This command will try to load and start Workbench. If RAMICON option
  14.        is used, LoadWB will use 'ENV:Sys/def_ramdisk.info' icon for the
  15.        Ram-Disk icon. If NEWPATH option is used, LoadWB will replace a
  16.        current Workbench search path with a search path of Shell from which
  17.        the LoadWB was issued. If Workbench is already running, the command
  18.        will do nothing (unless NEWPATH or RAMICON option is used).
  19.  
  20.    INPUTS
  21.        -DEBUG  - adds 'Debug' menu to the Workbench menus. There are two
  22.                  items under this menu:
  23.                      'ROMWack' starts internal ROM debugger, which requires
  24.                      a terminal to be connected to the Amiga internal serial
  25.                      port.
  26.                      'Flushlibs' removes all libraries, devices and fonts
  27.                      currently not in use thus freeing some memory.
  28.        DELAY   - forces LoadWB command not to return until Workbench is
  29.                  completely initialized (i.e. all disk icons are loaded and
  30.                  all WBStartup programs are started). If DELAY option does 
  31.                  not appear, LoadWB command will return as soon as Workbench
  32.                  is started.
  33.        CLEANUP - forces Workbench to execute 'Clean Up' function for main
  34.                  Workbench window after starting.
  35.        NEWPATH - lets you change current Workbench path. Normally, Workbench
  36.                  remembers path of the Shell that started Workbench. This
  37.                  path is inherited by all programs strated from Workbench.
  38.                  To change path of already running Workbench, you must use
  39.                  NEWPATH option. If Workbench has not been started yet, this
  40.                  option is ignored.
  41.        HIDE    - Workbench has a habit of putting 'NDOS:???' icons for all
  42.                  unrecognized disks. This is very annoying for users of
  43.                  CrossDOS and DiskSpare disks. HIDE will force Workbench
  44.                  to hide all those 'NDOS:???' icons, including the ones for
  45.                  unformatted disks. This option also implies DELAY.
  46.        RAMICON - changes the icon for a Ram-Disk. 'ENV:Sys/def_ramdisk.info'
  47.                  is used to represent the new Ram-Disk icon. This option
  48.                  can be used to set an icon for newly started Workbench
  49.                  or to change the Ram-Disk icon of running Workbench.
  50.                  This option also implies DELAY.
  51.  
  52.    RESULT
  53.        RETURN_FAIL  - if 'dos.library' or 'workbench.library' couldn't be
  54.                       opened or command line arguments couldn't be processed.
  55.        RETURN_ERROR - NEWPATH option was given but copy of current path
  56.                       couldn't be made (due to lack of memory).
  57.        RETURN_WARN  - Workbench was already running and NEWPATH option was
  58.                       not given or RAMICON option was given and there were
  59.                       some problems with the Ram-Disk icon.
  60.  
  61.    EXAMPLE
  62.        LoadWB HIDE
  63.            ; Load Workbench, hide all 'NDOS:???' icons. Command will not
  64.            ; return until Workbench is completely initialized.
  65.  
  66.        LoadWB DEBUG CLEANUP
  67.            ; Start Workbench with 'Debug' menu, move all icons after
  68.            ; starting.
  69.  
  70.        LoadWB NEWPATH
  71.            ; Set path of already running Workbench or just start it.
  72.  
  73.        LoadWB RAMICON
  74.            ; Start Workbench and use 'ENV:Sys/def_ramdisk.info' as a
  75.            ; Ram-Disk icon
  76.  
  77.    NOTES
  78.        To hide those 'NDOS:???' icons all DOS devices are removed before
  79.        starting Workbench and restored afterwards. This might affect
  80.        multitasking!
  81.        RAMICON works by copying 'ENV:Sys/def_ramdisk.info' to
  82.        'RAM:Disk.info' before Workench is started and deleting
  83.        'RAM:Disk.info' afterwards.
  84.        MakeLink is pure and can be made resident.
  85.  
  86.    BUGS
  87.        LoadWB NEWPATH sometimes hangs for a few seconds. This bug also
  88.        appears in LoadWB 38.9 command.
  89.  
  90.